home *** CD-ROM | disk | FTP | other *** search
/ Amiga Collections: Taifun / Taifun 251 (1993-09-10)(Manewaldt, A.)(DE)(PD).zip / Taifun 251 (1993-09-10)(Manewaldt, A.)(DE)(PD).adf / KILBM / KILBM_ENG.doc < prev    next >
Text File  |  1993-09-13  |  9KB  |  302 lines
  1.  
  2.                 KILBM V1.30
  3.  
  4.                - FREEWARE -
  5.  
  6.          (c) 1990-93 by Andreas R. Kleinert. All rights reserved.
  7.  
  8.           This program was written under OS V3.00 and is therefore
  9.           fully compatible. It needs OS >= V1.2.
  10.           This program needs 'ak_gen0.library' V37+ (in "LIBS:").
  11.  
  12.           Release Date : 10.05.1993
  13.  
  14.  
  15.     Copyright :
  16.     ===========
  17.  
  18.     The program KILBM and its documentation files are
  19.     (C)opyright 1990-93 by Andreas R. Kleinert. All rights reserved.
  20.  
  21.  
  22.     Disclaimer :
  23.     ============
  24.  
  25.     The author takes no responsibility for any results of the use of this
  26.     program.
  27.     This software is provided "AS IS" and there is no warranty of any kind,
  28.     so that you use this software at your own risk.
  29.  
  30.  
  31.     Distribution :
  32.     ==============
  33.  
  34.     The program KILBM V1.30 is freely distributable (FREEWARE).
  35.     You may copy it, if the copyright notice is left intact and
  36.     all of its parts are included in the distribution.
  37.     This program must not be included in commercial packages or commercial
  38.     program collections without my written permission.
  39.     This program must not be sold in any way, but it is allowed to take
  40.     a nominal fee including the costs for copying.
  41.  
  42.     This program may be put on public domain disks or included in public
  43.     domain disk libraries.
  44.     Special permission hereby goes to Fred Fish's AmigaLib-Disks and
  45.     the german series TAIFUN, FRANZ, TIME, GPD and Amiga Szene.
  46.  
  47.     This program may also be distributed via electronic mail and may be
  48.     put into mailboxes as long as the redistribution conditions are
  49.     respected in all points.
  50.  
  51.     By using or distributing this program you automatically agree to
  52.     all of the above conditions and terms.
  53.  
  54.  
  55.     Function :
  56.     ==========
  57.  
  58.     "KILBM" brings to you many possibilities to work with IFF-graphics :
  59.  
  60.      1) Showing of
  61.  
  62.        - packed and unpacked IFF-ILBM graphics
  63.        -        unpacked IFF-ACBM graphics
  64.  
  65.      2) Saving the screen as
  66.  
  67.        - packed or unpacked IFF-ILBM graphics.
  68.        -           unpacked IFF-ACBM graphics.
  69.  
  70.      3) Converting
  71.  
  72.        - IFF-ACBM graphics to IFF-ILBM graphics (packed/unpacked)
  73.        - IFF-ILBM graphics to IFF-ACBM graphics
  74.  
  75.  
  76.     The original file is not overwritten :
  77.     The destination file will be created with the extension ".ilbm"
  78.     or ".acbm" (depending on conversion mode).
  79.  
  80.     USE THIS OPTION CAREFULLY !!!
  81.  
  82.  
  83.     Additional Information :
  84.     ========================
  85.  
  86.     "KILBM" is the first in my small series of IFF-Reader und -Converter
  87.     programs.
  88.     Upto today there are also available :
  89.  
  90.     K8SVX     : For playing of IFF-8SVX-Samples.
  91.     KFTXT     : For reading and converting of IFF-FTXT-Files.
  92.     IFF-Arranger : Editing of IFF-Files (removing/adding of Chunks, ...)
  93.  
  94.  
  95.     Correspondence :
  96.     ================
  97.  
  98.     If you like, you may send me some money. Perhaps this will motivate me
  99.     to continue programming such programs or just making updates of
  100.     this one. Send bug-reports, money or whatever to :
  101.  
  102.        Andreas R. Kleinert,
  103.        Grube Hohe Grethe 23,
  104.        W-5900 Siegen 1,        since 1.7.93 : 57074 Siegen
  105.        Germany.
  106.  
  107.  
  108.     Usage :
  109.     =======
  110.  
  111.     To get a help "how to use" KILBM V1.30, just type "KILBM ?" in the
  112.     CLI/Shell-Window.
  113.     Then you'll get a full explanation of all of its possibilities.
  114.  
  115.     Note : All EHB- (Extra-Half-Brite-) and HAM- (Hold_And_Modify-)
  116.        Graphics should be displayed without any problems.
  117.        But don't blame me, if it doesn't work (nevertheless you
  118.        should report it ;)
  119.  
  120.  
  121.     History :
  122.     =========
  123.  
  124.      V1.30 : (original-length KILBM       : 13772 Bytes,
  125.      -------  original-length KILBM_light :  7068 Bytes)
  126.  
  127.       - now with Color-Cycling Routine
  128.     NOT YET 100% PERFECT !!!
  129.       - and more improvements
  130.  
  131.  
  132.      V1.29 : (original-length KILBM       : 12492 Bytes,
  133.      -------  original-length KILBM_light :  5540 Bytes)
  134.  
  135.       - Control-Window was not closed, when bug occured in Display-Routine
  136.       - now can be used as a Default-Tool for Workbench-Projects
  137.       - now checks Mousebottons no longer directly, but opens a window
  138.     on the Display-Screen with IDCMP_MOUSEBUTTONS
  139.  
  140.  
  141.      V1.28 : (original-length KILBM       : 12172 Bytes,
  142.      -------  original-length KILBM_light :  5272 Bytes)
  143.  
  144.       - another "bytes per line"-fix (IFF-ILBM and -ACBM-Display)
  145.       - lowest accepted library version now is V37 of "ak_gen0.library"
  146.       - now FileRequester for Picture-Display, if no parameters or
  147.     Workbench-Start
  148.       - new program : KILBM_light, for viewing only IFF-ILBM-Files
  149.     (ACBM-, Write- and Convert-Options are missing)
  150.  
  151.  
  152.      V1.27 : (original size : 11972 Bytes)
  153.      -------
  154.  
  155.       - changed way of getting "bytes per line"
  156.     (because of possible bugs)
  157.       - now also able to save V39-Workbench-Screens with
  158.     interleaved BitMap (like IFF-ILBM).
  159.     ONLY Workbench-Screens yet (checks for Screen->Flags & WBENCHSCREEN).
  160.       - REMOVED read functions for replacement of the WB-Screen
  161.     by IFF-ILBM/IFF-ACBM.
  162.     This option was not very useful, but very incompatible.
  163.       - consequent use of _tinymain/_exit
  164.       - 09.04.1993 : removed "About_IFF.doc"
  165.  
  166.  
  167.      V1.26 : (original size : 13580 Bytes)
  168.      -------
  169.  
  170.       - code-splitting, use of SAS/C's new Optimizer (for speed)
  171.       - changed order of arguments in command line !!!
  172.       - now VERY FAST in displaying pictures
  173.       - saved space : about 1500 Bytes
  174.       - new : if no additional option is specified, the picture is
  175.     just displayed ...
  176.  
  177.  
  178.      V1.25 : (original size : 15100 Bytes)
  179.      -------
  180.  
  181.       - use of SAS/C V6.00
  182.       - use of "ak_gen0"-pragmas
  183.       - optimizations
  184.       - more integrated construction of read, show and conversion routines
  185.       - saved space : about 3000 Code-Bytes
  186.  
  187.  
  188.      V1.21 / V1.22 : (original size : 18084 Bytes)
  189.      ---------------
  190.  
  191.       - correct reading and writing of 32-Bit CAMGs.
  192.     This hopefully allows support of all new ECS and AA ScreenModes.
  193.       - routine for "mode guessing" if CAMG not available (or corrupt)
  194.       - different routines for "V33"- and "V37+"-ScreenOpening
  195.       - explicitely use of topaz-8 font for Display-Screen
  196.       - "big" pictures, where "BMHD.pageWidth"  > "BMHD.w"
  197.                or "BMHD.pageHeight" > "BMHD.h"
  198.     should now be displayed correctly
  199.       - removed very last rest of "byte-count" things
  200.  
  201.  
  202.      V1.19 :
  203.      -------
  204.  
  205.       - removed CRNG- and CCRT-Support (mostly useless)
  206.       - joined "About_IFF_xxxx.doc" to "About_IFF.doc"
  207.  
  208.  
  209.      V1.18 :
  210.      -------
  211.  
  212.       - removed "byte-count" things
  213.       - removed unnecessary parameters in functions
  214.  
  215.  
  216.      V1.17 :
  217.      -------
  218.  
  219.       - removed some unecessary code-bytes
  220.       - added additional doc-files
  221.  
  222.     - About_ILBM.doc    : Explains intention of IFF-ILBM-File-Format
  223.                   shortly.
  224.     - About_ACBM.doc    : Explains intention of IFF-ACBM-File-Format
  225.                   shortly.
  226.  
  227.       - added additional warnings about careful use to this doc-file ...
  228.       - added "Additional Information" paragraph
  229.  
  230.  
  231.      V1.16 :
  232.      -------
  233.  
  234.       - use of pragmas (register parameters for system calls)
  235.       - rewrote parts of "printf()"-routine
  236.       - doc-fix :
  237.  
  238.      I forgot to mention at the top, that with V1.15
  239.      "ak_gen0.library" V35+ is needed.
  240.      (Error text already had been updated.)
  241.      This is because of prevention of bugs.
  242.  
  243.  
  244.      V1.15 :
  245.      -------
  246.  
  247.       - Lowest accepted library version now is V35 of "ak_gen0.library"
  248.       - won about 3700 Bytes because of own "printf()"-routine
  249.       - splitted some strings to save space
  250.       - reduced and corrected error strings and codes, also to save
  251.     space (and to prevent bugs/misunderstandings)
  252.       - a future support of things like "locale.library" would now
  253.     be much easier (I hope)
  254.       - fixed a bug, which occured, when displaying packed/unpacked
  255.     IFF-ILBM or IFF-ACBM-Brushes (only ODD-LINED Brushes)
  256.       - fixed same bug in conversion-routines (-ci/-cim/-ca)
  257.       - safety check for screen opening has been added
  258.     (now code becomes more and more longer, but even shorter than before !)
  259.       - could not use global optimizer (GO), because with it there
  260.     occured some silly bugs (don't know which reason),
  261.     so we need some more code-bytes
  262.       - converted files now get the extension ".ilbm" (for -ci/-cip)
  263.     or ".acbm" (for -ca)
  264.  
  265.  
  266.      V1.12 :
  267.      -------
  268.  
  269.       - Hopefully fixed a bug, that would have caused problems, when saving
  270.     Screens other than 640x256.
  271.     Note : Overscan limit is (as far as I know) 704x283 or 736x290.
  272.            KILBM also manages things like 724x283 (x + 20), but other
  273.            programs might not accept this.
  274.       - Well it also seems, that now brushes are displayed correctly.
  275.     (Tested with ENV:sys/pointer.ilbm (Brush) of the WB V2.04.
  276.      Showing of ENV:sys/palette.ilbm (Brush f. Colors) also didn't cause
  277.      any problems.)
  278.       - "doc-fixes"
  279.       - translated some german output-texts into english (and "sorted" them
  280.     new)
  281.  
  282.  
  283.      V1.11 :
  284.      -------
  285.  
  286.       - First official released FREEWARE version.
  287.  
  288.  
  289.      V1.00 - V1.10 :
  290.      ---------------
  291.  
  292.       - Private work versions. Not released.
  293.  
  294.  
  295.     Copyrights :
  296.     ============
  297.  
  298.     Some of the mentioned names or products above may be copyrighted by
  299.     companies or trademarks of companies.
  300.  
  301.  
  302.